react-activity-calendar
Advanced tools
A flexible React component to display activity data in a calendar (heatmap).
Documentation (Storybook)
npm install react-activity-calendar
The component expects activity data in the following structure. Each activity level must be in the
interval from 0 to maxLevel, which is 4 per default (see
documentation).
It is up to you how to generate and classify your data.
import { ActivityCalendar } from 'react-activity-calendar'
const data = [
{
date: '2024-06-23',
count: 2,
level: 1,
},
{
date: '2024-08-02',
count: 16,
level: 4,
},
{
date: '2024-11-29',
count: 11,
level: 3,
},
]
;<ActivityCalendar data={data} />
If you encounter issues rendering this component in a specific React framework, please refer to the following repository. It contains working examples for Astro, Next.js, Remix and Vite. Server side rendering (SSR) is supported.
Create React App (CRA) is considered abandoned, and you probably should not use it anymore (more background). Using this component inside CRA will lead to errors for reasons described in issue #105. This repo is not for CRA support questions. If you encounter issues, you need to fix those yourself given the maintenance state of CRA. Personally, I would recommend using Vite instead of CRA.
It seems impossible to support all kinds of tooltip libraries since they are all implemented differently. See this issue and especially this comment. The next major version will be based on a headless approach for tooltips, so that styling is completely up to the user.
npm run storybook
npm run build:storybook
FAQs
React component to display activity data in calendar
The npm package react-activity-calendar receives a total of 11,649 weekly downloads. As such, react-activity-calendar popularity was classified as popular.
We found that react-activity-calendar demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Ransomware payment rates hit an all-time low in 2024 as law enforcement crackdowns, stronger defenses, and shifting policies make attacks riskier and less profitable.
Security News
require(esm) backported to Node.js 20, easing the transition to ESM-only packages and reducing complexity for developers as Node 18 nears end-of-life.
Security News
PyPI now supports iOS and Android wheels, making it easier for Python developers to distribute mobile packages.